home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / f90 / alog.z / alog
Encoding:
Text File  |  2002-10-03  |  3.9 KB  |  95 lines
  1. ALOG(3I)                                              Last changed: 4-13-99
  2.  
  3.  
  4. NNAAMMEE
  5.      LLOOGG, AALLOOGG, DDLLOOGG, QQLLOOGG, CCLLOOGG, CCDDLLOOGG, CCQQLLOOGG - Computes natural logarithm
  6.  
  7. SSYYNNOOPPSSIISS
  8.      LLOOGG (([XX==]_x))
  9.      AALLOOGG (([XX==]_x))
  10.      DDLLOOGG (([XX==]_x))
  11.      QQLLOOGG (([XX==]_x))
  12.      CCLLOOGG (([XX==]_x))
  13.      CCDDLLOOGG (([XX==]_x))
  14.      CCQQLLOOGG (([XX==]_x))
  15.  
  16. IIMMPPLLEEMMEENNTTAATTIIOONN
  17.      UNICOS, UNICOS/mk, IRIX systems
  18.  
  19.      CF90, MIPSpro 7 Fortran 90, MIPSpro Fortran 77
  20.  
  21. SSTTAANNDDAARRDDSS
  22.      Fortran
  23.  
  24.      Fortran extensions:  QQLLOOGG, CCDDLLOOGG, CCQQLLOOGG
  25.  
  26. DDEESSCCRRIIPPTTIIOONN
  27.      LLOOGG is the generic function name; the others are specifics.  These are
  28.      elemental intrinsic functions.  They accept the following argument:
  29.  
  30.      _x         For AALLOOGG, DDLLOOGG, and QQLLOOGG, _x must be greater than zero and of
  31.                type real.  For CCLLOOGG, CCDDLLOOGG, and CCQQLLOOGG, _x must be of type
  32.                complex and not equal to ((00..,,00..)).  The type and kind type of
  33.                _x is identical to the type and kind type of the return
  34.                value.  See the RETURN VALUES section for information on
  35.                input data types and return values.
  36.  
  37.      Vector versions of these intrinsics exist on some systems.  Vector
  38.      versions of AALLOOGG, DDLLOOGG, CCLLOOGG, and CCDDLLOOGG exist on UNICOS and UNICOS/mk
  39.      systems.  On UNICOS/mk systems, the vector versions of these
  40.      intrinsics are used when --OO vveeccttoorr33 or --OO33 are specified on the
  41.      compiler command line.  A vector version of the single-precision and
  42.      double-precision LLOOGG intrinsic exists on IRIX systems and is used when
  43.      --OO33 is specified on the compiler command line.
  44.  
  45.      These functions evaluate _y = ln(_x).
  46.  
  47.      CCDDLLOOGG is called implicitly by as a result of a generic AALLOOGG call with
  48.      a complex double-precision argument.
  49.  
  50. NNOOTTEESS
  51.      The AALLOOGG, DDLLOOGG, and CCLLOOGG intrinsic function names can be passed as
  52.      arguments; the others cannot.
  53.  
  54.      On CRAY T90 systems that support IEEE arithmetic, the following return
  55.      values occur:
  56.  
  57.           AALLOOGG((00)) = -infinity
  58.  
  59.           AALLOOGG((--00)) = NaN
  60.  
  61.           AALLOOGG((_x)) = NaN if -infinity <= _x < 0
  62.  
  63.           AALLOOGG((infinity)) = infinity
  64.  
  65. RREETTUURRNN VVAALLUUEESS
  66.      The generic function LLOOGG becomes a call to one of the other functions
  67.      depending on the type of its argument.
  68.  
  69.      AALLOOGG returns the real natural logarithm of its real argument.
  70.  
  71.      DDLLOOGG returns the double-precision natural logarithm of its
  72.      double-precision argument.
  73.  
  74.      QQLLOOGG returns the quad-precision natural logarithm of its
  75.      quad-precision argument.
  76.  
  77.      CCLLOOGG returns the complex natural logarithm of its complex argument.
  78.      Its argument cannot equal ((00..,,00..)).  The range of the imaginary part is
  79.      -pi < _i_m_a_g_i_n_a_r_y__p_a_r_t <= pi.
  80.  
  81.      CCDDLLOOGG returns the complex double-precision natural logarithm of its
  82.      complex double-precision argument.
  83.  
  84.      CCQQLLOOGG returns the complex quad-precision natural logarithm of its
  85.      complex quad-precision argument.
  86.  
  87.      The data type and kind type for real, double-precision, and
  88.      quad-precision values differ depending on your platform.  For
  89.      platform-specific information, see the TERMINOLOGY section of the
  90.      IINNTTRROO__IINNTTRRIINN(3I) man page.
  91.  
  92. SSEEEE AALLSSOO
  93.      _I_n_t_r_i_n_s_i_c _P_r_o_c_e_d_u_r_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l for the printed version of this
  94.      man page.
  95.